ApplicationPoolFailureSettings Class [IIS 7 and higher]
Exposes properties that determine the actions to be taken when an application pool or worker process fails.
Syntax
class ApplicationPoolFailureSettings : EmbeddedObject
Methods
This class contains no methods.
Properties
The following table lists the properties exposed by the ApplicationPoolFailureSettings class.
Name |
Description |
|---|---|
AutoShutdownExe |
A read/write string value that specifies an executable file to run when the World Wide Web Publishing Service (WWW service) shuts down an application pool. The default is null. Use the AutoShutdownParams property to send parameters to the executable. |
AutoShutdownParams |
A read/write string value that contains the command-line parameters for the executable file specified by the AutoShutdownExe property. The default is null. |
LoadBalancerCapabilities |
A read/write sint32 value that specifies application pool behavior when a service is unavailable. The possible values are listed later in the Remarks section. |
OrphanActionExe |
A read/write string value that specifies an executable file to run when the WWW service orphans a worker process. The default is null. Use the OrphanActionParams property to send parameters to the executable file. |
OrphanActionParams |
A read/write string value that contains the command-line parameters for the executable file specified by the OrphanActionExe property. To specify the process ID of the orphaned worker process, use "%1%". The default is null. |
OrphanWorkerProcess |
A read/write boolean value. true if the WWW service orphans a worker process that fails to respond to requests; otherwise, false. The default is false. When the value is set to false, any worker process that fails to respond will be terminated. |
RapidFailProtection |
A read/write boolean value. true if the WWW service will terminate all applications in an application pool when the number of worker process failures reaches the maximum specified by RapidFailProtectionMaxCrashes within the number of seconds specified by RapidFailProtectionInterval; otherwise, false. The default is true. |
RapidFailProtectionInterval |
A read/write datetime value that specifies the number of seconds before the failure count for a worker process is reset. The default is 5. |
RapidFailProtectionMaxCrashes |
A read/write uint32 value that specifies the maximum number of permissible worker process failures. The default is 5. |
Subclasses
This class contains no subclasses.
Remarks
Instances of this class are contained in the Failure property of the ApplicationPool class and the ApplicationPoolElementDefaults class.
The following table lists the possible values and the associated keywords and actions for the LoadBalancerCapabilities property. The default is 2 (HttpLevel).
Value |
Keyword |
Action |
|---|---|---|
1 |
TcpLevel |
Terminates the connection. |
2 |
HttpLevel |
Sends error code 503 (service unavailable). |
Inheritance Hierarchy
ApplicationPoolFailureSettings
Requirements
Type |
Description |
|---|---|
Client |
Requires IIS 7 on Windows Vista. |
Server |
Requires IIS 7 on Windows Server 2008. |
Product |
IIS 7 |
MOF file |
WebAdministration.mof |
See Also
Reference
ApplicationPool Class [IIS 7 and higher]
ApplicationPoolElementDefaults Class [IIS 7 and higher]
EmbeddedObject Class [IIS 7 and higher]